home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / network / manageme / tcpdump-.001 / tcpdump-~ / tcpdump-3.0.2-linux / libpcap-0.0.6 / INSTALL < prev    next >
Encoding:
Text File  |  1995-04-28  |  4.9 KB  |  122 lines
  1. @(#) $Header: INSTALL,v 1.5+ 94/06/20 18:56:52 leres Exp $ (LBL)
  2.  
  3. To build libpcap, first customize any paths in Makefile.in, then run
  4. ./configure (a shell script).  "configure" will determine your system
  5. attributes and generate an appropriate Makefile from Makefile.in.  Next
  6. run "make", and if everything goes well, su and run "make install".
  7. (If you're system is not listed in the README as one which we have
  8. tested, you may have to modify the configure script and Makefile.in;
  9. please send us patches for any modifications you need to make.)  You
  10. need not install libpcap if you just want to build tcpdump (but make
  11. sure tcpdump and libpcap have the same parent directory during the
  12. build).
  13.  
  14. You will need an ANSI C compiler to build libpcap.  If your compiler is
  15. not ANSI compliant, use the GNU C compiler, available via anonymous
  16. ftp:
  17.  
  18.     ftp://prep.ai.mit.edu/pub/gnu/gcc-*.tar.gz
  19.  
  20. If you do use gcc, you must run the "fixincludes" script. The configure
  21. script automatically detects this possible configuration problem.
  22.  
  23. If you use flex, version 2.4.6 or higher is recommended.  The current
  24. version of flex is available via anonymous ftp:
  25.  
  26.     ftp://ftp.ee.lbl.gov/flex-*.tar.Z
  27.  
  28. Earlier versions of 2.4 require declarations for some internal memory
  29. allocator routines.  Version 2.3 and earlier caused typedef conflicts
  30. with sys/types.h.  If you don't have a version of flex that works,
  31. plain old lex works ok.  But if you use lex/yacc, libpcap will have
  32. symbols that will conflict with other yacc/lex generated code (yes,
  33. this can be fixed with a script that maps the yy* identifiers, but flex
  34. and bison do this automatically so we haven't bothered).  Note that the
  35. stock version of flex under DEC OSF/1 is 2.3.
  36.  
  37. If you use Solaris, there is a bug with bufmod(7) that is supposed to
  38. be fixed in 5.3.2.  Setting a snapshot length with the broken bufmod(7)
  39. results in data be truncated from the FRONT of the packet instead of
  40. the end.  The work around is to not set a snapshot length but this
  41. results in performance problems since the entire packet is copied to
  42. user space.  There is a patch available from Sun; ask for bugid
  43. 1149065.  After installing the patch, use "setenv BUFMOD_FIXED" to
  44. enable use of bufmod(7).
  45.  
  46. If linking tcpdump fails with "Undefined: _alloca" when using bison on
  47. a Sun4, your version of bison is broken. In any case version 1.16 or
  48. higher is recommended (1.14 is known to cause problems 1.16 is known to
  49. work). Either pick up a current version from:
  50.  
  51.     ftp://prep.ai.mit.edu/pub/gnu/bison-*.tar.gz
  52.  
  53. or hack around it by inserting the lines:
  54.  
  55.     #ifdef __GNUC__
  56.     #define alloca __builtin_alloca
  57.     #else
  58.     #ifdef sparc
  59.     #include <alloca.h>
  60.     #else
  61.     char *alloca ();
  62.     #endif
  63.     #endif
  64.  
  65. right after the (100 line!) GNU license comment in bison.simple, remove
  66. grammar.[co] and fire up make again.
  67.  
  68. If you are running a version of SunOS earlier than 4.1, you will need
  69. to replace the Sun supplied /sys/sun{3,4,4c}/OBJ/nit_if.o with the
  70. appropriate version from this distribution's SUNOS4 subdirectory and
  71. build a new kernel:
  72.  
  73.        nit_if.o.sun3-sunos4        (any flavor of sun3)
  74.        nit_if.o.sun4c-sunos4.0.3c    (SS1, SS1+, IPC, SLC, etc.)
  75.        nit_if.o.sun4-sunos4        (Sun4's not covered by
  76.                         nit_if.o.sun4c-sunos4.0.3c)
  77.  
  78. These nit replacements fix a bug that makes nit essentially unusable in
  79. pre-SunOS 4.1.  In addition, our sun4c-sunos4.0.3c nit gives you
  80. timestamps to the resolution of the SS-1 clock (1 us) rather than the
  81. lousy 20ms timestamps Sun gives you  (tcpdump will print out the full
  82. timestamp resolution if it finds it's running on a SS-1).
  83.  
  84. FILES
  85. -----
  86. CHANGES        - description of differences between releases
  87. INSTALL        - this file
  88. Makefile.in    - compilation rules (input to the configure script)
  89. README        - description of distribution
  90. RUNSON        - list of supported hardware and operating systems
  91. VERSION        - version of this release
  92. bpf/net        - copies of bpf_filter.c and bpf.h
  93. bpf_image.c    - BPF disassembly routine
  94. checkioctl.c    - gcc test program
  95. configure    - configure script (run this first)
  96. etherent.c    - /etc/ethers support routines
  97. ethertype.h    - ethernet protocol types and names definitions
  98. gencode.c    - BPF code generation routines
  99. gencode.h    - BPF code generation definitions
  100. grammar.y    - filter string grammar
  101. inet.c        - network routines
  102. mkdep        - construct Makefile dependency list
  103. nametoaddr.c    - hostname to address routines
  104. net        - symlink to bpf/net
  105. optimize.c    - BPF optimization routines
  106. pcap-bpf.c    - BSD Packet Filter support
  107. pcap-dlpi.c    - Data Link Provider Interface support
  108. pcap-enet.c    - enet support
  109. pcap-int.h    - internal libpcap definitions
  110. pcap-namedb.h    - public libpcap name database definitions
  111. pcap-nit.c    - Network Interface Tap support
  112. pcap-nit.h    - Network Interface Tap definitions
  113. pcap-pf.c    - Packet Filter support
  114. pcap-pf.h    - Packet Filter definitions
  115. pcap-snit.c    - Streams based Network Interface Tap support
  116. pcap-snoop.c    - Snoop network monitoring support
  117. pcap.3        - manual entry
  118. pcap.c        - pcap utility routines
  119. pcap.h        - public libpcap definitions
  120. savefile.c    - offline support
  121. scanner.l    - filter string scanner
  122.